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ABSTRACT 

This  paper  describes  the  design  of  an  interactive  system  to  aid  in 
the  analysis  of  problems  which  involve  directed  graphs.   The  digital 
computing  system  is  assumed  to  have  a  graphic  display  device  on  which 
directed  graphs  may  be  drawn  and  from  which  light  pen,  function  key- 
board, and  alphanumeric  keyboard  information  may  be  transmitted  on-line 
to  the  system.   Directed  graphs  are  represented  in  core  storage  by  a 
dynamically  allocated  hierarchical  list  structure.   User-written  analysis 
routines  are  linked  to  the  system  to  apply  it  to  a  particular  field  of 
problems.   An  initial  implementation  of  its  capabilities  on  the  IBM  360/67 
with  an  IBM  2250  Display  Unit  was  written  in  PL/l  (F) .   Under  the  IBM 
System/360  Operating  System,  it  executed  in  less  than  200K  bytes  and 
provided  reasonable  response  to  on-line  interaction. 
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I.   INTRODUCTION 

This  paper  describes  a  system  designed  to  aid  in  the  on-line 
analysis  of  problems  which  involve  directed  graphs.   Likely  appli- 
cations include  PERT  network  analysis,  electronic  circuit  analysis  and 
artificial  intelligence.   A  PL/l  (F)  program  was  implemented  on  the  IBM 
System/360  Model  67  using  the  IBM  2250  Display  Unit  and  approximately 
200K  bytes  of  core  storage.   The  program  demonstrates  some  of  the 
capabilities  of  the  system  described  and  is  appended  with  a  users' 
manual  to  this  paper. 

Chapter  II  gives  definitions  and  explains  concepts  used  in  the 
paper  and  the  program.   Directed  graphs,  progressions,  reachable  sets, 
and  cells  and  pointers  used  in  list  processing  are  presented. 

The  design  of  the  program  is  described  in  Chapter  III.   Discussed 
therein  are  some  of  the  goals  of  an  interactive  system.   This  chapter 
also  contains  a  detailed  description  of  a  hierarchical  list  structure 
representing  a  directed  graph  and  a  sample  algorithm  which  traverses 
the  structure . 

Chapter  IV  concludes  the  paper  with  some  comments  on  the  system  and 
implementation.   A  program  listing  appears  as  the  last  section  of  the 
paper.   Output  from  a  sample  run  is  also  included  with  some  pictures  of 
the  2250  Display  Unit  during  a  run.   Finally,  Appendix  A  contains  a 
users'  manual  for  the  program. 


II.   FUNDAMENTAL  CONCEPTS 

In  this  chapter,  basic  concepts  of  directed  graphs  essential  to 
understanding  this  paper  are  developed.   Many  of  the  definitions  are 
from  a  text  written  by  Busacker  and  Saaty  [1],   Their  textbook  Finite 
Graphs  and  Networks  contains  concise  definitions  used  in  graph  theory. 
Their  book  also  discusses  many  graph  theory  applications. 

Some  definitions  in  graph  theory  have  not  found  universal  accept- 
ance.  In  order  to  avoid  unnecessary  confusion,  this  paper  will  use 
the  terminology  consistent  with  Busacker  and  Saaty  [1]. 

A  directed  graph  is  usually  an  abstract  model  of  a  real  situation. 
To  arrive  at  an  unambiguous  definition  of  an  abstract  graph,  Euclidean 
3-dimensional  space  is  employed  to  define  a  geometric  graph,  then  from 
that  the  definition  of  an  abstract  graph  is  obtained.   Euclidean 
3-space  consists  of  triplets  of  real  numbers. 

A.   GEOMETRIC  GRAPHS 

A  simple  open  curve  in  Euclidean  3-space  is  a  continuous,  non- 
self-intersecting  curve  joining  two  distinct  points.   A  simple  closed 
curve  is  the  same  as  a  simple  open  curve  except  that  it<  endpoints 
coincide.   Now,  a  geometric  graph  in  Euclidean  3-space  is  a  set 
V  =  £v.j  of  points  in  Euclidean  3-space  and  a  set  A  =  {a.£  of  simple 
curves  (open  and  closed)  satisfying  the  following  conditions: 

1)  The  closed  curves  in  A  contain  only  one  point  in  V. 

2)  The  open  curves  in  A  have  as  endpoints  two  points  in  V. 

3)  No  two  curves  in  A  have  common  points  except  for  points  in  V 


Thus,  a  geometric  graph  is  simply  a  system  of  points  connected  by 
curves.   The  curves  intersect  one  another  only  at  points  in  V.   The 
most  common  real  life  example  might  be  a  network  of  highways  —  inter- 
sections representing  points  and  the  highways  between  intersections 
representing  curves. 

B.   ABSTRACT  GRAPHS 

The  notion  of  a  geometric  graph  is  indeed  concise,  but  carries  with 
it  more  information  than  is  normally  needed  in  the  applications  of 
graph  theory.   The  exact  spacial  location  of  the  points  of  a  graph  in 
Euclidean  space  is  not  essential  in  most  directed  graph  analysis.   The 
most  important  property  of  a  geometric  graph  is  the  connectivity  of 
the  graph:   which  two  vertices  in  V  are  connected  by  a  curve  in  A. 
The  connectivity  of  a  graph  now  can  be  described  with  the  following 
notation : 

A(a.) >  (Vj,vk) 

which  reads,  "curve  a,  starts  at  vertex  v.  and  ends  at  vertex  v.".   In 

1  j  k 

this  manner  each  curve  in  A  is  mapped  into  an  ordered  pair  of  vertices 
in  V.   Each  of  the  possible  ordered  pairs  of  the  elements  in  V  are 
elements  of  the  cartesian  cross  product  V  X  V.   If  V  =  ?v-,>v9(>  then 
the  set  V  X  V  =  {(v^v^,  (v^v^,  (v^v^,  (v2,v2)]. 

An  abstract  graph  or  simply  a  graph  is  composed  of  a  set  (of 
vertices)  V,  a  set  (of  arcs)  A,  and  a  mapping  of  A  into  V  X  V.   The 
definition  must  also  include  the  restriction  that  no  element  of  A  is 
in  V.   This  last  statement  stresses  the  point  that  in  i  n  abstract  graph 
a  point  cannot  also  be  a  curve. 


The  system  G.  =  (V^A^A  )  is  a  subgraph  of  a  graph  G  =  (V,A,A) 
if  the  following  conditions  are  satisfied: 

1)  V   is  a  subset  of  V  and  A   is  a  subset  of  A. 

2)  For  every  a  in  A  ,  A  (a)  =  A(a) . 

3)  For  every  a  in  A.,  if  An  (a)  •->  (v., v.),  then  v.  and  v.  are 
elements  of  V..  J  J 

The  system  G,  =  (V, ,A  ,  A  )  is  an  induced  subgraph  of  G  =  (V,A, A) 

if  the  following  conditions  are  satisfied: 

1)  G,  is  a  subgraph  of  G. 

2)  Every  arc  a,  A(a)  — >  (u,v),  in  A  is  in  A   if  u  and  v  are 
elements  of  V  . 

Although  an  abstract  graph  is  not  defined  in  a  3-dimensional  space, 
it  is  often  useful  if  net  invaluable  to  picture  this  abstract  model  by 
drawing  it  on  a  piece  of  paper  or  displaying  it  on  a  cathode  ray  tube. 
Through  man's  heuristic  properties,  drawings  and  pictures  seem  to  mean 
more  than  just  describing  a  graph  as  two  sets  and  a  mapping  function. 
Solving  some  graph  theory  problems  depends  to  some  degree  on  a  drawing 
of  a  graph.   Any  drawing  of  a  graph,  for  which  the  only  common  points 
of  arcs  are  the  vertices,  is  called  a  geometric  realization  of  the  graph, 
Many  geometric  realizations  of  a  given  graph  exist.   If  a  graph  is 
defined  as  G  =  (V,A,A),  V  =  |v.  ,v_  ,vA ,  A  =  £a..,a2,a-J,  and 

A(aL)  >  (v1,v2),  A(a2)  >  (v2>v3),  and  A(a3)  >  (v],v;3);  then 

one  comprehends  more  about  the  graph  by  looking  at  some  of  its  geo- 
metric realizations  shown  in  Figure  1.   Each  one,  because  it  looks 
different  from  the  others,  imparts  different  unquantif iable  infor- 
mation.  This  is  one  of  the  reasons  for  the  use  of  the  IBM  2250  Display 
Unit  in  the  design  and  operation  of  the  system. 


v,   a,        v,  a2      v3 

*  B»S fe.«* 


p»g ^»» 


v2       a2       v3 


Ql\       /a3 


Figure  I-    Three    geometric    realizations    of    a    graph 


G.   PROGRESSIONS 

An  arc  progress  ion  is  an  ordered  sequence  of  arcs  a..  ,  a„  ,  a~  ,  .  .  .  ,  a 

satisfying  one  condition: 

An  ordered  sequence  of  nodes  v..  v_  ,  ...,  v  in  must  exist 
such  that 


A(a.)->  (vi,vi+1),  i  =  1,2,3, 


n. 


A  path  progression  is  an  arc  progression  for  which  v,  fi   v   , ,  and 
no  arc  appears  in  the  sequence  more  than  once. 

A  cycle  progression  is  an  arc  progression  for  which  v,  =  v    and 
no  arc  appears  in  the  sequence  more  than  once. 

The  length  of  a  progression  is  simply  the  number  of  arcs  in  the 
sequence,   A  progression  is  said  to  lead  from  v1  _to  v    ,  or,  the 
progression  starts  at  v,  and  ends  at  v  ...  .   An  arc  a  which  maps  into 
(v,w)  is  positively  incident  with  the  initial  node  v  and  negatively 
incident  with  the  terminal  node  w. 

Consider  the  graph  G  in  Figure  2.   Some  progressions,  their  type, 
length,  and  starting  and  ending  nodes  are  shown  in  Table  I.   Some 
sequences  of  arcs  which  are  not  progressions  are  shown  in  Table  II. 
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Figure    2.  A    directed     graph 


Some  progressions     Type     Length 


a3'a4 
a2'a4'a5 
a2 'a4 '35 'a2 
al'a3'a4'a5 
a4'a5'al,a3 


path 

1 

path 

2 

eye  le 

3 

arc 

4 

eye  le 

4 

eye  le 

4 

From 


To 


Table  I.   Progressions  in  graph  G  in  Figure  2. 


al'a2 
Va3 


a3,a2,a4 


a2'a3 
al'a3'a2 


Table  II.   Some  sequences  in  graph  G  which  are 
not  progressions. 


D.   REACHABLE  SETS 

During  the  analysis  of  a  graph,  some  algorithms  "look  at"  a  node, 

say  v.,  and  ask,  "Which  nodes  are  at  the  end  of  arcs  starting  at  v.?" 

Using  the  definition  of  a  progression,  the  question  may  be  restated: 

Which  nodes  are  at  the  end  of  all  length  1  progressions  starting  at 

v.?   This  set  of  nodes  is  called  the  reachable  set  of  the  node  v.  and 
1  l 

is  denoted  R(v.).   The  superscript  of  the  reachable  set  is  the  length  of 
progressions  considered.   R  (v.)  is  the  set  of  nodes  which  are  at  the  end 
of  all  length  n  progressions  starting  at  v.. 
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R   (v.)  is  the  set  of  starting  nodes  of  all  length  n  progressions 
ending  at  v..   R  (v. ,v_ , . . . ,v.)  is  the  union  of  the  sets  R  (v.), 
R  (v„),  ...,  R  (v.).   To  cover  all  possible  integer  values  of  n, 

An  arc  is  said  to  be  a  loop  is  it  starts  and  ends  at  the  same 
node.   Therefore,  if  a.  is  a  loop  starting  and  ending  at  v.,  then 
v.  is  in  R(v.).   Further,  since  an  arc  may  be  repeated  in  an  arc 
progression,  v.  would  also  be  in  R  (v.)  for  all  values  of  n. 

Consider  the  graph  G  in  Figure  3.   Some  reachable  sets  are 

presented  in  Table  III.   Note  that  if  R  (v.)  of  any  node  v.  contains 

v- ,  then  R   (v.)  also  contains  v_  for  m  =  1,  2,  3,  ...  due  to  the 
2  l  2 


loop  a,, 


Figure  3.    A    directed     graph     with    a    loop 


R"(v) 


arc  progressions 


v2,vl'v3 
v2,v1,v3 

v2,v5 

v2,v1,v3,v4,v5 


v2,v1 
v,  ,v. 


-}5  1*    2 

R  JXv1)      v2,vL,v3, 


a6;   a    ;  and  a2 

a5'a6;   a5,al;   and  a5,a2 

a3,a4'a5  an     a3,aA'a7 
a4,a5,a6,a6,a6,a6;   a^ ,a5 ,a6 ,a^ ,a^ ^  ; 

a4,a5'a2'a4,a5'a2  '  a4'a5'a6'a6'a2,a4; 
and  a4,a     a6,a2,a4,a5 

a2>a4  and  ao»aA 

a2'a4,a7  a   a3'a4'a7 

a6'a6'  a6'al'  al,a3'  an  a2'a4 


Table  III.   Some  Reachable  Sets  of  graph  G  in  Figure  3. 
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The  definition  of  a  path  reachable  set  is  similar  to  that  of  the 

reachable  set.   The  path  reachable  set  of  node  v.,  P  (v.),  is  the  set 

j x>  x* 

of  all  nodes  at  the  end  of  all  length  n  path  progressions  starting  at 

v..   P   (v.)  is  defined  as  the  set  of  starting  nodes  of  all  length  n 

progressions  ending  at  v..   Again,  to  cover  all  possible  integer 

values  of  n,  P  (v.)  is  defined  as  the  empty  set  cp.   P  (v.  ,v_  ,v»  , .  .  .  ,v,  ) 

A  cumulative  reachable  set  R  (v . )  =  7  U  R  (v.M.   Likewise,  the 

c  J   Ci=0    J  j 

cumulative    path   reachable    set    P   (v.)   =  JU   P    (v«)l.      Table    IV  shows    some 
c      J         /i=l  JJ 

path   reachable   sets    of   graph  G   in  Figure   3. 

path   progressions 

1  v2  Vl,v3  ax  and  a2 

2  v4  v3'vl'v2  a5,a2'   a5'al  a        a5'a6 

3  vn  v-.v,.  a„, a,, a,   and  a., a,, a. 


V 

P  (v) 

V2 

v1,v3 

V4 

v3,v1,v2 

Vl 

v2,v5 

V3 

vl 

v4 

V1'V2 

v5 

V1'V2 

F3(vx) 

V1'V3'V4 

43'   4*   5 3'   4'    7 

4         v3  vx  aA>a5>a6'al 

-2  v^  vl,v2  a3,a4  a        a2'a4 

-3         vs  vl,v2  a3'a4'a7   an°  a2'a4,a7 

2    P5^)      vl,v3'v4    a6'al'  al'a3;  and  a2'a4 

Table  IV.   Some  path  reachable  sets  of  graph  G  in  Figure  3. 

E.   SUPER- NODES  AND  SUPER-ARCS 

In  many  applications  of  graph  theory,  the  number  of  nodes  and  arcs 
is  quite  large.   Consider  the  geometric  realization  of  a  graph  of  every 
street,  alley,  thoroughfare  and  intersection  of  a  large  city  like 
Chicago.   If  one  could  find  a  sheet  of  paper  large  enough  on  which  to 
draw  it,  the  probability  of  drawing  it  without  error  would  be  quite 
small.   Assuming  that  it  has  been  drawn  successfully,  using  it  to 
answer  various  questions  about  Chicago  would  be  difficult  if  not 
impossible!   For  instance,  if  the  question,  "How  many  thoroughfares 


12 


intersect  Interstate  80,"  were  asked,  one  would  have  to  sift  through 
the  maze  of  alleys  and  residential  streets  to  first  locate  Interstate 
80  at  some  point  on  the  drawing.   Then  one  would  have  to  follow  it 
asking  at  each  intersection  if  the  streets  connected  to  Interstate  80 
were  thoroughfares.   It  would  be  much  easier  to  attack  the  overall 
problem  in  a  manner  similar  to  the  approach  used  by  the  county  cart- 
ographers.  Draw  a  map  showing  just  Interstate  highways  and  inter- 
sections with  major  thoroughfares.   Also  put  on  the  map  references  to 
sectional  maps  showing  in  a  little  more  detail  the  area  concerned. 
The  sectional  map  might  also  contain  references  to  detail  maps  showing 
all  streets  and  alleys  of  a  sub-subsection  of  the  city.   Answering  the 
questions  above  would  be  much  easier.   One  would  not  be  forced  to 
bother  with  the  small  streets  and  alleys.   If  a  question  were  asked 
which  called  for  information  about  the  small  streets  and  alleys  of  the 
city,  one  could  reference  the  detail  maps  as  desired. 

This  is  perhaps  an  overworked  example  justifying  the  concept  of  a 
super-node.   The  idea  is  simple:   Represent  an  induced  subgraph  with  a 
single  super-node,  maintaining  connections  to  and  from  the  subgraph  in 
the  following  manner. 

Let  G,  =  (V, ,A  ,  A  )  be  an  induced  subgraph  of  G  =  (V,A,A).   Let 

super-node  v.,  be  an  element  of  V  representing  the  subgraph  G, . 

If  A(a)  >  (u,v)  such  that  u  e  V-V,  and  v  e  V1 ,  then  a  is 

negatively  incident  with  v... 

If  A(a)  >  (v,u)  such  that  v  e  V.  and  u  e  V-V,,  then  a  is 

positively  incident  with  v. . . 

An  arc  which  is  incident  with  a  super-node  is  called  a  super-arc . 

To  completely  specify  a  graph  containing  super-nodes  and  super-arcs, 

additional  notation  is  used  to  define  a  graph  G  =  (V,A,V).   To  completely 
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specify  a  super-node  in  V,  the  graph  that  it  represents  must  be 
associated  with  the  super-node.   If  v  is  a  super-node  in  V  representing 
graph  G.  =  (V..  ,A  ,V  )  ,  then  the  node  v  appears  with  the  name  of  the 
represented  graph  enclosed  in  parentheses.   Thus,  v(G.)  is  an  element 

of  V.   The  set  of  arcs  A  is  the  same  as  defined  before,   a.  is  an 

1 

element   of  A   if  a.    is   a   simple  arc   or   super-arc    in  G.      Additional 

notation  V  replacing   the  mapping   A  indicates   all   incident   nodes    of 

all  arcs . 

The  sequence  of  characters  V(a)  is  defined  for  each  arc  a.   The 

characters  consist  of  parentheses,  brackets,  commas  and  node  names. 

The  order  of  characters  is  determined  in  the  following  manner: 

V(a),  the  sequence  of  characters  defining  arc  a  in  G, 
is  defined  using  an  ordered  pair  of  sequences. 


7(a)  -  <[F  (u)],  [F  (v)]) 

Cl  It 


where 


u  is  the  starting  node  in  G  of  arc  a,  and 
v  is  the  ending  node  in  G  of  arc  a. 

The  sequence  of  characters  represented  by  F  (v)  is  defined 

a. 


v  if  v    is   a   simple   node. 

v,F    (v1)      if  v    is   a   super-node. 

a 

If  v  is  a  starting  node  of  arc  a,  then  v'  is  the 

starting  node  of  a  in  the  graph  represented  by  v. 

If  v  is  an  ending  node  of  arc  a,  then  v1  is  the 
ending  node  of  a  in  the  graph  represented  by  v. 

The  recursion  must  gi  ;  a  finite  sequence  of  nodes,  because  every  arc 

eventually  starts  or  c'ids  at  a  simple  node. 

If  V(a)  =  ([u15u2,u3,  ...,  ui],  [v1,v2,v3,  ...,  v  ]),  then  a,  u^ 

and  v.  are  in  the  same  graph.   u.  and  v,  are  the  starting  and  ending 
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super-nodes  of  the  super-arc  a.   u.  and  v.  are  the  starting  and  ending 
simple  nodes  of  arc  a.   u  and  v   are  in  the  subgraphs  represented  by 
u,  ,  and  v    for  k  =  2,3,4,  ...,  i  and  I  =  2,3,4,. ..,j. 

The  graphs  shown  in  Figures  4,  5,  and  6  demonstrate  the  use  of  the 
super-node  concept.   First,  a  graph  G  is  defined  in  Figure  4. 


Figure   4.     A   detailed     graph 


Then,  replacing  the  induced  subgraph  determined  by  v_,  v_  ,  v.,  and  v^ 
with  a  super-node  v,,  gives  the  graphs  G. ,  the  detail  graph  represented 
by  super-node  v..,  and  Gi,  the  altered  graph  G.   Arcs  a„ ,  a,  and  a  are 
part  of  the  subgraph  G. .   Graphs  G'  and  G.  are  shown  in  Figure  5. 


~-$-3V4 


(a)    Graph    G( 


(b)    Graph    G' 


Figure    5.     A   graph  G1    containing   a   super-ncde 
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The  following  information  not  shown  about  the  super-arcs  is 

maintained  in  the  sequences  V(a)  : 

Super-arc  a.,  not  only  ends  at  v^  in  G',  but  also  at  v„  in  G,  . 

In  a  similar  manner,  arc  a9  ends  at  v..,  in  G1  and  at  v„  in  G,  . 

Super-arc  a,  starts  at  vin  in  G1  and  v.  in  G. . 
r        6  11  4     1 

Super-arc  a   starts  at  v....  in  G'  and  v-  in  G,  . 
Noting  that  v  ,  and  v  are  the  ending  nodes  of  two  arcs  which 
start  at  v, ,  and  are  also  the  starting  nodes  of  two  arcs  which  end  at 
v,  ;  graph  G"  is  constructed  by  representing  with  super-node  v...  the 
induced  subgraph  G~  consisting  of  v,,  and  v7.   Since  all  arcs  and 
super-arcs  of  G'  start  or  end  at  v..  or  v  ,  they  all  become  super-arcs 
in  G" .   The  resulting  graphs  arc  shown  in  Figure  6. 


(a)  Graph    G" 

v2j  represents  G2 


(b)   Graph    G2 

v„   represents  G| 


•  v. 


(c)    Graph    Gj 

Figure  6.     A  system  of  graphs    containing   super-nodes 

and    super-arcs 
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The  following  information  not  shown  is  maintained  in  the  (a)  sequences: 

Super-arc  a  ends  at  v~   in  G"  ,  v   in  G»  and  v_  in  G, . 

Super-arc  a~  ends  at  v»  1  in  G" ,  v   in  G„  and  v_  in  G-.  . 

Super-arc  a  ends  at  v    in  G"  and  v,  in  G0 . 
o  2  i  12. 

Super-arc  a?  starts  at  v?   in  G",  v   in  G?  and  v,  in  G. . 

Super-arc  a,  starts  at  v01  in  G" ,  vin  in  G„  and  v,  in  G, . 
6  21         11     2      4     1 

Super-arc  a   starts  at  v_   in  G"  and  v   in  G  . 
Table  V(a)  shows  the  sequences  F  (v)  for  the  system  of  graphs  in  Figure 

SL 

6.   The  sequences  V(a)  of  the  system  are  in  Table  V(b).   These 
sequences  contain  all  information  necessary  to  construct  the  original 

graph  G  in  Figure  4. 

F  (v) 

v  a  av  ' 

VI  al'a2'a3'a6'a7'  and  a9  Vl 
v„             a  and  a  v„ 

v3         a2'a4  and  a5  v3 

v.  ac  and  a,  v. 

4  5      6  4 

vc         a_  ,a,  and  a..  vr 

5  3  4      7  5 

v6         a6,a7  and  ag  v6 

v?  ag  and  ag  v? 

VII  al  Vll'Fal(v2)   =V11'V2 
Vll  a2  Vll'Fa2(V  =V11'V3 
Vll  a6  vll»Fa6(v4)   =V11'V4 
vll  a7  Vll'Fa7(v5)  =V11'V5 
V21  al  v21»Fal(vll>  =V21'V11'V2 
v21  a2  ^l'^lP  =  V21'V11'V3 
v21  a6  V21'Fa6(vll}  =  v21'vll'v4 
V21  a7  ^I'^lP  =  V21'V11'V5 
V21  a8  V21'Fa8(v7)  =V21'V7 
v21  a9  v21'Fa9(v7)  =  V21'V7 

(a)  The  sequences  F  (v)  for  the  graphs 
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a  V(a) 

ax  ([Vj],  [v21,vn,v2]) 

a2  CfVj],  tv2i'vn'v3^ 

a3  ([v2],  [v5]) 

a4  ([v3],  [v5]) 

a5  ([v3],  [v4]) 

a6  <[V21'V11'V4]'  [V6]) 

a?  ([v21»Vll'V5]'  [V6]) 

ag  ([Vj^],  [v21,v7]) 

a9  ([v21,v7],  [v6l) 

(b)  The  sequences  V(a)  for  the  graphs 
Table  V.   F  (v)  and  V(a)  for  the  graphs  in  Figure  6. 

F.   CELLS  AND  POINTERS 

The  internal  representati  n  of  the  user's  graphs  are  in  the  form  of 
a  list  which  is  composed  of  cells.   A  cell  is  a  logically  contiguous 
block  of  computer  storage  locations.   The  storage  locations  in  a  cell 
are  divided  into  one  or  more  fie  Ids .   Each  cell  has  a  unique  address 
which  is  the  storage  location  of  the  first  field  in  the  cell.   Each 
field  of  a  cell  has  a  unique  displacement  from  the  first  field.   The 
address  of  a  field  of  a  particular  cell  is  the  address  of  the  cell 
plus  the  displacement  of  the  field  within  the  cell.   A  field  may  be 
used  to  store  characters,  real  or  integer  numbers,  or  addresses  of 
other  cells.   A  storage  location  (not  necessarily  in  any  cell)  is 
called  a  pointer  if  it  is  used  to  hold  the  address  of  a  cell.   Thus, 
a  cell  may  contain  fields  used  as  pointers  (i.e.,  a  cell  may  point  to 
several  other  cells  or  itself!).   A  unique  pointer  value  is  reserved  to 
indicate  that  the  pointer  with  this  value  does  not  point  to  a  cell. 
This  value  is  called  the  NULL  value  and  is  represented  by  the  character 
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A.   A  variable  is  a  symbolic  name  representing  the  contents  of  a 
unique  storage  location  not  in  any  cell. 

Consider  a  list  representing  a  deck  of  cards.   Each  cell  represents 
one  card.   Each  cell  consists  of  three  fields  named  DENOM,  SUIT,  and 
NEXT.   DENOM  is  the  denomination  of  the  card  (2,  3,  ...  king,  ace), 
SUIT  is  the  suit  (club,  heart,  etc.)  and  NEXT  is  a  pointer  identifying 
the  cell  which  represents  the  next  card  in  the  deck.   TOP,  LAST  and  P 
are  unique  pointer  variables.   To  aid  in  interpreting  the  list  in 
Figure  7b,  a  key  is  given,  Figure  7a,  to  show  the  relative  position 
of  the  fields  in  a  drawing  of  a  CARD  cell.   The  values  of  pointers  are 
indicated  by  arrows.   Note  that  the  NEXT  arrows  start  in  a  cell  and 
point  to  the  boundary  of  the  next  cell. 


TOP 


DENOM 


SUIT 


NEXT 


(a)  Key;   CARD  cell 


i. 


fiCE 


CLUBS 


LAST 


rp 


KING 

HEARTS 

1 


TWO 

SPADES 


A 


FIVE 


SPADES 


TWO 


CLUBS 


JACK 


HEARTS 


X 


(b)    A  deck  of    cards 


Figure  7     A  list  representing  a    card    deck 
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TOP  is  a  pointer  variable  which  identifies  the  top  card  of  the  deck. 
TOP's  DENOM  is  "ace".   We  may  set  P  (another  pointer  variable)  equal 
to  TOP's  NEXT  as  shown.   Then  P's  DENOM  is  "king".   P  may  be  moved  on 
down  the  deck  by  setting  P  equal  to  P's  NEXT.   Finally,  P  will  equal 
1AST.   Note  that  LAST's  NEXT  is  NULL  indicating  the  end  of  the  deck. 

One  need  not  be  concerned  with  assigning  particular  storage 
locations  to  variables  and  cells.   Higher  level  programming  language 
compilers  accomplish  this  clerical  task.   The  important  point  is  that 
each  variable  is  a  different  storage  location  not  among  those,  com- 
prising cells  . 
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III.   THE  DESCRIPTION  OF  THE  PROGRAM 

A.   GOALS  OF  THE  PROGRAM 

As  it  is  implied  by  the  title,  all  of  the  goals  of  the  system  may 
be  summed  up  as  follows:  To  provide  a  man-machine  interactive  system 
used  in  solving  directed  graph  problems. 

To  be  truly  interactive,  the  total  system  (hardware  and  software) 
must  keep  the  user's  mind  on  the  directed  graph  problem.   Use  of  a 
computing  system  with  a  cathode  ray  tube  display  unit  allows  instan- 
taneous communications  between  the  user  and  a  program.   Also,  the 
program  must  be  efficient;  the  system  must  process  the  commands  as 
fast  as  the  user  can  issue  them.   Indeed,  the  user  realizes  that  an 
on-line  system  is  to  be  responsive  and  becomes  irritated  when  it  is 
not.   Peak  loads  on  a  multiprogrammed  computing  system  will  cause  a 
lag  in  response  time  no  matter  how  efficient  the  software  is.   Since 
the  on-line  user  becomes  irritated  upon  waiting  four  seconds  or  more 
for  the  machine  to  avail  itself  for  the  next  command,  the  on-line 
system  should  frequently  test  the  time  elapsed  from  the  entry  of  the 
last  user  command.   If  the  elapsed  time  is  approaching  four  seconds, 
processing  should  be  interrupted  to  display  an  apologetic  message  to 
the  user  explaining  the  cause  of  delay. 

It  has  been  observed  that  users  of  on-line  systems  become  irritated 
when  obviously  needed  commands  are  not  available  or  selection  of  commands 
is  a  complicated  process  (e.g.,  searching  a  list  of  operations  for  a 
numeric  code  to  be  entered).   The  user's  train  of  thought  is  forced  to 
leave  the  realm  of  the  problem  to  become  involved  with  the  inadequacies 
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of  the  system.   Therefore,  this  system  is  designed  to  use  the  light 
pen  detection  facility  and  a  complete  list  of  alphabetic  mnemonic  com- 
mands displayed  on  the  screen  of  the  display  unit--the  simplest  and 
quickest  means  available  for  communications  between  the  system  and  the 
user. 

The  on-line  user  realizes  that  the  system  is  merely  a  device 
existing  to  serve  him;  therefore,  he  should  not  be  treated  rudely  by 
the  system.   If  he  is,  he  will  choose  not  to  use  the  system,  or  if 
forced  to,  will  spend  many  an  unhappy  hour  with  it--def inite ly  not  a 
characteristic  of  a  good  interactive  system.   The  tone  of  messages  to 
the  user  incorporated  in  this  system  is  that  of  a  courteous  laborer 
working  for  the  user. 

Conserving  the  resources  of  the  user  should  be  a  goal  of  any  system, 
on-line  or  not.   It  is  assumed  that  the  multiprogrammable  computer  will 
have  three  or  more  jobs  to  work  on  while  not  processing  commands  from 
the  user.   Thus,  the  facilities  of  the  computer  are  not  wasted  by 
having  it  wait  for  the  user  to  enter  a  command.   Also,  use  of  a  pro- 
gram overlay  feature  decreases  the  amount  of  core  storage  allocated  to 
this  system. 

This  system  is  designed  to  use  dynamic  storage  allocation  instructions 
to  construct  a  PL/l  list  structure  representing  the  user's  graphs.   The 
use  of  this  feature  not  only  conserves  storage,  but  lends  the  use  of 
the  system  to  a  variety  of  graph  theory  applications.   User-written 
routines  are  linked  to  the  system  thus  specializing  it  for  use  with  a 
particular  application.   The  user,  through  the  routines  he  provides, 
may  associate  additional  fields  with  nodes  and  arcs  (e.g.,  resistance, 
inductance,  etc.).   He  also  provides  analysis  routines  which  access  the 
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list  structures.   System  routines  are  provided  to  aid  the  user  in  his 
analysis  and  display  of  his  results. 

Many  short  sessions  with  a  system  is  psychologically  more  pleasant 
than  fewer  extended  sessions.   Therefore,  directed  graphs  may  be  saved 
as  a  sequential  data  set  at  the  end  of  a  session.   This  data  set  may  be 
used  to  initialize  the  system  at  the  beginning  of  the  next  session. 

Because  of  the  interactive  nature  of  the  system,  it  lends  itself 
to  on-line  design  of  directed  graphs.   Thus,  the  user  may  modify  the 
graph,  call  his  analysis  routines  and  from  the  output  of  the  analysis, 
make  more  modifications,  and  so  forth  until  the  optimal  design  is 
reached.   He  may  prepare  before  his  first  session  a  card  deck  from 
which  the  system  will  obtain  the  initial  graph  structure.   The  card 
format  is  designed  to  be  relatively  free  of  restrictions.   To  fully 
utilize  the  interactivity  of  the  system,  corrections  for  errors  found 
in  the  card  deck  are  requested  from  the  user  on-line. 

In  conclusion,  the  system  designed  is  flexible  —  to  meet  the  desires 
of  a  variety  of  users.   It  is  on-line--to  take  advantage  of  man's 
heuristic  nature.   And,  it  is  courteous--to  make  use  of  the  system 
pleasant , 

B.   SYSTEM  DESIGN 

Because  the  user  must  program  his  own  analysis  routines  and  link 
them  to  the  system,  a  discussion  of  the  overall  design  is  presented. 

Basically,  the  user  is  provided  with  a  PL/l  main  program  and  a 
series  of  subroi:  ines  which  perform  three  functions: 

1)  Drive  the  display  unit. 

2)  Generate  and  modify  the  user's  list-structured  directed  graphs 

3)  Call  user  analysis  routines. 
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When  a  function  key  at  the  display  unit  is  pressed,  the  system  calls 
the  user  routine  named  BUTTONS.   Since  the  system  variables  are 
declared  "EXTERNAL,"  the  user  has  access  to  their  current  values  and 
can  use  them  in  his  analysis.   The  user  may  display  the  results  of 
his  analysis  by  calling  a  system  routine  to  save  the  current  display 
preparing  it  for  his  use;  or,  by  calling  call  another  routine  which 
displays  a  "page"  of  user-generated  text.   Use  of  either  procedure 
allows  him  to  use  the  light  pen,  function  keyboard,  and  alphanumeric 
keyboard  for  his  own  purposes . 

C.   THE  LIST  STRUCTURE 

The  PL/I  List  Processing  features  are  used  extensively  to  construct 
a  representation  of  the  user's  directed  graphs  in  core  memory.   Allo- 
cations of  two  based  structures  which  represent  two  types  of  cells 
are  linked  together  to  form  the  directed  graphs.   NODE  is  the  level  1 
identifier  of  the  structure  used  to  represent  nodes  of  the  graph  and 
ARC  is  the  level  1  identifier  of  the  structure  used  to  represent  an  arc 
Each  allocation  of  either  structure  is  called  a  cell.   The  structures 
are  declared  as  follows: 

DECLARE   1  NODE  BASED  (PP)  , 

2  LABEL  CHARACTER (4), 

2  NEXT  POINTER, 


2  DOWN  POINTER, 

1  ARC  BASED  (P-ARC) , 
2  SON  POINTER, 


2  MORE  POINTER; 
To  avoid  confusion,  some  of  the  level  2  elements  in  the  structures  are 
not  shown  here.   They  will  be  explained  later. 
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The  integer  1  preceding  NODE  and  ARC  indicate  that  NODE  and  ARC 
are  symbolic  names  representing  all  of  the  fields  of  one  of  the  cells. 
The  integer  2  beginning  the  lines  under  1  NODE  and  1  ARC  establish 
symbolic  names  and  displacements  for  the  fields  in  the  NODE;  likewise 
for  SON  and  MORE  in  the  ARC  cells.   The  word  BASED  instructs  the  PL/l 
compiler  to  generate  code  which  will  dynamically  allocate  core  storage 
upon  the  execution  of  the  ALLOCATE  statement  and  will  free  storage 
upon  the  execution  of  the  FREE  statement. 

The  NEXT  and  DOWN  fields  in  NODE  cells  and  SON  and  MORE  in  ARC 
cells  are  used  as  pointers,  that  is,  they  are  used  to  hold  addresses 
of  unique  cells.   By  program  convention,  the  DOWN  and  SON  fields  always 
point  to  ARC  cells.   This  makes  traversing  the  lists  less  complicated. 

A  NODE  cell  is  allocated  for  each  node  and  an  ARC  cell  is  allo- 
cated for  each  arc  of  a  graph.   The  DOWN  pointer  of  the  NODE  cell 
points  to  a  list  of  ARC  cells.   The  MORE  field  links  the  list  of  ARC 
cells  similar  to  the  way  NEXT  linked  the  CARD  cells  in  Figure  7.   All 
of  the  arcs  represented  by  the  ARC  cells  in  a  list  start  at  the  same 
node.   The  SON  pointer  of  an  ARC  cell  points  to  the  ending  node  of 
the  arc.   Figure  8  shows  a  list  structure  demonstrating  the  use  of  the 
two  fields  in  each  cell.   It  is  called  a  partial  list  structure  because 
not  all  fields  are  shown.   The  letters  appearing  immediately  above  each 
ARC  cell  serve  merely  to  identify  the  ARC  cell;  only  node  labels  are 
stored  in  the  list  structure. 

From  Figure  8,  we  may  make  the  following  observations: 

1)  ARC  cell  Al  represents  arc  a 
ARC  cell  A2  represents  arc  a 
ARC  cell  A3  represents  arc  a». 
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NODE  cell         ARC  cell 


V2  "3 

(a)    A  graph   Gl 


LABEL 

SON 

MORE 

DOWN 

(b)    Key 


VI 

Al    l 

r        s 

— 

A 

(c)    Partial  list  structure  of  graph  Gl 


Figure  8.  A  graph  Gl  and  its  list  structure 


2)  The  label  of  a  node  is  stored  in  the  LABEL  field  of  the 
NODE  cells. 

3)  The  DOWN  pointer  of  NODE  cell  labelled  V3  has  a  NULL  value 
indicating  that  there  are  no  arcs  starting  at  v„  . 

4)  There  is  no  unique  order  for  arcs  appearing  on  the  list  of 
ARC  cells.   For  instance,  ARC  cell  A2  may  have  come  directly  under  NODE 
cell  VI  and  ARC  cell  Al  under  ARC  cell  A2 . 
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To  facilitate  processing,  the  NODE  cells  are  put  into  a  list 
linked  by  the  NEXT  pointer  and  another  NODE  cell  called  the  graph 
header  ce 11  is  added  in  which  to  store  the  name  of  the  graph  and  to 
provide  a  starting  point  for  processing  the  graph.   Use  of  the  NEXT 
pointer  and  addition  of  the  graph  header  cell  is  shown  in  Figure  9. 


(a)    A  graph  61 


NODE  cell      ARC  cell 


LABEL 

SON 

NEXT 

MORE 

DOWN 

(b)  Key 


(c)   List  structure  of  graph   Gl 


Figure  9.  A  graph  Gi  and  its  list  structure 
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Because  many  graphs  may  be  in  core  simultaneously,  a  list  of  ARC 
cells  linked  by  the  MORE  pointer  is  maintained  with  the  SON  pointers 
identifying  the  graph  header  cells  of  the  graphs  in  core.   The  system 
pointer  variable  SUPLIST  (mnemonic  for  super  list)  points  to  the  top  of 
this  list.   Figure  10  shows  the  use  of  these  ARC  cells  and  the  pointer 
SUPLIST. 


ARC  ce 


SUPLIST  ^ 


MORE 


(a)  Key 


(b)  T.(e  list  structure 

Figure  10.   A  list  structure  showing  the  use  of 
the  system  pointer  variable  SUPLIST 
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SUPLIST   is   set    to   the   NULL  pointer  value    if  no  graphs   are    in   the 

system.      Note    that    through   the   variable   SUPLIST,    the   system  and   user 

routines    can  access   all   of   the   graphs   active   at   any   time. 

To   store    the    information   necessary   to   indicate    that   a   cell   of  a 

graph   represents   a   super-node   or   super-arc,    some   additional   fields   are 

needed    in   the    cells: 

DECLARE    1   NODE   BASED    (PP)  , 

2    LABEL  CHARACTERS)  , 

2   NEXT   POINTER, 
2    SNODE    POINTER, 
2   HINFO   POINTER, 

2   DOWN  POINTER, 

1  ARC  BASED    (P-ARC) , 
2    SON   POINTER, 
2    SARC    POINTER, 
2  AINFO   POINTER, 
2    PSARC    POINTER, 
2    PAINFO   POINTER, 

2  MORE   POINTER; 

Consider  Figure    11a   and  b.      Graph   G2   contains   a   NODE  cell  Vll 

which   is   a   super-node   representing  a   copy   of  graph   Gl .      SNODE   of 

the   super-node   cell   points    to  Gl's   graph   header   cell,    identifying 

the   graph   that    it   represents.      An  ARC   cell    labelled  IH   is   added   to 

the    list   of  ARC  cells    pointed   to  by   the  DOWN  pointer   of  Gl's   graph 

header   cell.      An  ARC   cell  will  appear   on  this    list    for  each  copy   of  the 

graph  currently    in  the    system,      "his  ARC   cell    is   called  an   interface 

header  cell.      Its   SON  field   points    to   the   super-node's   NODE   cell.      Its 

MORE   field   points    to  more    interface   header   cells    of  Gl,    NULL  in   this 

case.      Its  AINFO  field   points    to  a    list    of   interface  ARC  cells.      Figure 

lid   shows    the    linkage   between   a   super-node   cell  Vll,   a   graph  header 

cell  Gl,    and  an    interface    header   cell   IH.      The   characters    "(XXX)"   in 
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the  drawing  of  a  list  indicate  that  the  field  is  a  pointer  identifying 
the  cell  labelled  XXX.   All  ARC  cells  have  a  label  representing  its 
address  just  above  it. 

The  list  of  interface  ARC  cells  form  the  "interface"  between  a 
super-node  and  a  copy  of  the  graph.   This  interface  concept  allows 
many  copies  of  the  graph  to  exist  without  using  computer  storage  for 
a  separate  copy  of  the  graph  for  each  super-node.   Also,  processing 
time  may  be  reduced  significantly.   Consider  the  analysis  of  a  PERT 
network  representing  the  construction  of  a  fifty  story  office  building. 
A  graph  F  may  be  designed  to  represent  the  activities  necessary  for  con- 
structing one  floe --one  node  in  F  for  each  activity.   Then,  another 
graph  B  which  represents  construction  of  the  entire  building  is 
designed  containing  among  other  nodes,  fifty  super-nodes  each  repre- 
senting the  const  action  of  a  floor,  graph  F.   The  PERT  routine  would 
first  determine  critical  path  values  for  graph  F  and  associate  these 
values  with  each  super-node  representing  graph  F.   Then,  graph  B  is 
analyzed  by  the  PERT  routine. 

If  the  graph  F,  on  the  other  hand,  were  duplicated  fifty  times  and 
merged  into  graph  B,  the  analysis  of  graph  F  would  occur  fifty  times. 
It  is  apparent  that  a  similar  saving  in  time  and  storage  would  be 
made  by  applying  this  concept  to  other  problems  (e.g.,  the  analysis 
of  an  electronic  circuit  containing  many  "copies"  of  a  simple  amplifier) 

The  representation  of  the  last  piece  of  vital  information—with 
which  nodes  in  the  graph  Gl  of  Figure  11  are  the  super-arcs  in  G2 
incident--is  now  unveiled.   First,  the  ARC  cells  which  start  or  end  at 
v,,  in  G2  are  super-arcs.   Their  SARC  and  AINFO  fields  were  left  blank 
in  Figure  11.   Also,  the  AINFO  field  of  the  interface  header  cell  points 
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to  a  "list  of  interface  ARC  cells".   This  list  and  the  empty  fields 
of  the  super-arc  cells  define  with  which  nodes  the  super-arcs  are 
incident . 

There  is  one  ARC  cell  in  this  list  for  each  super-arc  starting  or 
ending  at  v..-.   An  ARC  cell  in  G2  is  denoted  as  representing  a  super- 
arc  by  setting  either  its  SARC  or  AINFO  pointers  (or  both)  to  point  to 
a  unique  cell  on  the  appropriate  interface  list—depending  on  the 
starting  and  ending  nodes  in  G2 . 

If  the  ending  node  is  a  super-node,  then  the  SARC  field  of  the 
super-arc  cell  is  set  to  point  to  an  interface  ARC  cell.   The  inter- 
face ARC  cell  is  on  the  list  of  interface  ARC  cells  identified  by  the 
HINFO  field  of  the  ending  super-node  cell.   This  interface  ARC  cell's 
SARC  field  points  to  the  node  in  Gl  at  which  the  super-arc  also  ends. 

If  the  starting  node  is  a  super-node  then  the  AINFO  field  of  the 
super-arc  cell  points  to  an  interface  ARC  cell.   This  interface  ARC 
cell  is  on  the  list  of  interface  ARC  cells  identified  by  the  HINFO 
field  of  the  starting  super-node  cell  in  G2 .   The  AINFO  field  of  the 
interface  ARC  cell  points  to  the  super-arc's  starting  node  in  Gl. 

If  both  the  starting  and  ending  nodes  of  a  super-arc  are  super- 
nodes,  then  pointers  are  set  as  described  above.   The  SON  field  of 
an  interface  ARC  cell  points  to  its  interface  header  cell.   Figure  12 
shows  the  linkage  between  the  super-node  Vll,  super-arcs  Al  and  A2 ,  and 
the  interface  ARC  cells  IA1  and  IA2 .   Cells  labelled  IAn  are  interface 
ARC  cells,  Al  and  A2  ?.re   super-arc  cells,  and  the  cell  labelled  IH  is 
an  interface  header  cell. 

An  example  showing  a  three  graph  system  with  a  super-arc  between 
two  super-nodes,  a  super-arc  starting  at  three  nodes  (each  in  a 
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different  graph),  and  showing  multiple  copies  of  a  graph  appears  in 
Figure  13  . 

Graph  G3  =  (V3»A3>V3>» 
where 

V3  =  [V21(G2)'V12(G1)J 
A3  -  {aj 

V3*a4^  =^V21,V11'V1^'  fvi2'v2^ 
Graph  G2  =  (V2,A2,V2), 

where 

V2  =  fv4'Vll(G1)* 

A2  =  U3{ 

V^(a3)  =  ([v4],  [v11,v3]) 

Graph  Gl  =  (V^A^V^, 

where 

Vl  =  fwv3* 

Al  =  *al'a2* 

\(aj)   =  ([vj,  [v3]) 

Vfa2)  =  ([vjh  [v2]). 
Since  super-arcs  may  start  (or  end)  at  several  super-nodes,  each 
in  a  different  graph,  the  PAINFO  (and  PSARC)  field  is  needed  in  which 
to  store  this  information.   The  following  set  of  rules  determine  the 
number  and  field  values  of  interface  arc  and  header  cells: 

1)  There  exists  an  interface  header  cell  IHij  under  Gi's 
graph  header  cell  for  each  super-node  SNij  representing  graph  Gi . 

2)  IHij's  SON  points  to  a  unique  super-node  SNij  representing 
graph  Gi. 

3)  IHij's  AINFO  points  to  a  list  of  interface  ARC  cells  IAijk. 

4)  An  interface  ARC  cell  exists  for  each  super-arc  eventually 
starting  or  ending  at  SNij. 

5)  IAijk's  SON  points  to  IHij. 
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6)  IAijk's   SARC   points    to  a   node   Nip   in  Gi    if   the   kth   super- 
arc    in   the   system  eventually    incident  with   node   Nip  ends   at   node   Nip. 

7)  IAijk's  AINFO   points    to  a   node   Niq   in  Gi    if  the   kth   super- 
arc    in   the   system  eventually    incident  with   node  Niq   starts   at  node  Niq. 

8)  IAijk's    PSARC   points    to   IAlmn   if 

a)  IAijk's   SARC   points    to  a   super-node   SNlm   in  Gi. 

b)  The   super-arc   associated  with    IAijk  also  ends   at   SNlmn. 

c)  The  kth   super-arc    incident  with  node   Nip   is   also   the 
nth   super-arc    incident  with  SNlm. 

9)  IAijk's    PAINFO  points    to   IAlmn   if 

a)  IAijk's  AINFO  points    to   super-node   SNlm   in  Gi . 

b)  The   super-arc   associated  with   IAijk  also  starts   at   SNlm. 

c)  The   kth   super-arc    incident  with   Niq   is   also  the   nth 
super-arc    incident  with   SNlm. 

10)   Otherwise,    the    fields    in   the    interface  ARC  and   interface 
header   cells    (except  MORE)   are   set    to   the   NULL  value. 

Figure    13d   shows    the    list   structure    reflecting   the   use   of   interface 

ARC  and   interface   header  cells.      Note,    for  example,    that    the    starting 

node   of  A4  can  be   traced    (through   IA1)    to  Vll,    then    (through   IA3)    to 

VI.      Also,    given  a   graph,    say  GI,    one   can   immediately    locate   all 

super-nodes  which   represent    the   graph,   V12   and  Vll,    and    from  there,    the 

super-arcs  which   start  and  end  at   nodes    in   the   graph,  A4  and  A3. 

D.      USER  ROUTINES 

Because   the   system   is   not   designed    for  a   particular  application, 
the    task  of  applying    it   to  an  application   is    left   to   the   user.      The 
routines    the   user  must    provide   are   application-oriented  and  are 
divided    into   two  classes.      One   class   handles   user-defined    fields   and 
cells.      The   other   class   consists    of  analysis   routines.      System  routines 
are   provided   to  assist   the    user   in   the   programming  and   implementation 
of  his   routines.      Also,    system  variables   are   declared    "EXTERNAL". 
Therefore,    their  values  may  be   accessed   at   any   time. 
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User-defined  fields  and  cells  are  set  up  by  the  system  in  the 
following  manner.   First,  each  NODE  cell  of  the  directed  graphs  has 
four  fields  which  are  available  for  his  use.   Each  time  a  node  is 
added  to  or  deleted  from  a  graph,  a  user  routine  narked  N_USER  is 
called.   ..  pointer  to  the  cell  and  a  variable  set  to  one  for  add  or 
two  for  delete  is  passed  to  this  routine.   This  routine  may  then  use 
a  system  routine  to  retrieve  information  from  the  display  device  on- 
line to  set  the  fields  reserved  for  his  use.   The  following  fields 
are  set  aside  in  the  NODE  cells:   XCOR  and  YCOR  are  FLOAT  BINARY (21), 
ON_OFF  is  BIT(2),  and  USER  is  a  POINTER.   The  user  may  design  and 
allocate  storage  for  his  own  cells  to  hold  more  information  related 
to  a  node  and  set  USER  to  address  his  cells.   This  routine  is  called 
just  before  a  node  is  deleted  so  that  he  may  free  the  storage  used 
for  any  of  his  cells. 

Likewise,  one  pointer  field  in  each  ARC  cell  may  be  used:   USERA. 
N_USER  is  called  in  a  similar  manner;  however, the  calling  integer 
argument  is  set  to  three  for  add  and  to  four  for  delete. 

Thus,  during  analysis,  the  user  may  access  these  values  stored  in 
the  cells,  use  them  for  computations  and  perhaps  re-store  new  values 
to  be  displayed  later. 

After  his  graphs  have  been  put  into  the  system,  he  may  press  a 
function  key.   Another  user  routine  is  called:   BUTTONS.   The  number 
of  the  function  key  pressed,  0  through  31,  is  passed  to  this  routine. 
He  may  then  perform  an  analysis  of  the  graphs,  display  textual  infor- 
mation using,  if  desired,  a  system  routine  DISPAGE,  or  cause  a  printed 
output  of  one  or  more  graphs—again,  optionally  using  another  system 
routine  P  ARCS. 
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The  last  routine  named  ANALYZE  must  be  provided.   It  is  invoked 
by  positioning  the  light  pen  on  the  displayed  option:   ANALYZE. 
Again,  he  may  initiate  any  of  the  actions  above  (including  calling 
BUTTONS  with  a  dummy  function  key  number!). 

The  user's  manual  in  Appendix  A  contains  a  detailed  discussion  of 
the  system.   The  program  listing  of  an  initial  implementation  on  the 
IBM  360/67  appears  in  the  Computer  Program  Section. 

E.   A  SAMPLE  ALGORITHM 

To  demonstrate  how  the  list  structure  can  be  traversed,  algorithm 
P  is  shown  which  will  construct  the  path  reachable  set  P  (v),  given 
two  arguments:   N,  the  length  of  path  progressions  considered  and  PN, 
a  pointer  identifying  the  NODE  cell  representing  v. 

First,  an  algorithm  is  shown  which  checks  an  array  of  pointers  to 
see  if  the  last  one  is  a  duplicate  of  any  of  the  pointers  above  it. 
This  algorithm,  named  CHECK,  will  be  called  in  algorithm  P  to  determine 
whether  the  arc  progressions  generated  in  P  are  also  path  progressions. 
In  the  algorithm  CHECK,  POINTERS  is  an  input  one-dimension  array  of 
pointers.   LAST  is  the  index  of  the  last  element  in  the  POINTERS  array. 
POINTERS (1)  is  the  first  element.   RESULT  will  be  set  to  one  if  the 
last  element  in  POINTERS  is  not  in  the  array  twice;  it  will  be  set  to 
two  if  the  last  element  is  duplicated. 

ALGORITHM  CHECK (POINTERS , LAST, RESULT) 


1.  RESULT  < 1 

2.  IF  LAST  is  less  than  2  THFN  RETURN 

3.  I  < 1 

4.  IF  POINTERS (I)  equals  POINTERS (LAST) 

then  GO  TO  STEP  8. 

5.  I  < I  +  1 

6.  IF  I  equals  LAST  THEN  RETURN 

7.  GO  TO  STEP  4. 

8.  RESULT  < 2 

9.  RETURN 
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Algorithm  P  constructs  all  possible  arc  progressions  of  the 
length  desired.   WSEQ  is  a  one -dimension  array  of  pointers  identifying 
the  arc  progression.   IW  is  an  integer  indicating  the  last  element  in 
WSEQ  used.   Each  time  an  arc  is  added  to  WSEQ,  algorithm  CHECK  is 
called  to  determine  whether  the  arc  is  already  on  the  list.   If  so, 
the  arc  progression  is  not  a  path  progression;  thus,  the  algorithm 
explores  another  arc  progression.   If  a  progression  with  no  repeating 
arcs  contains  N  arcs  then  the  ending  node  of  the  last  arc  in  WSEQ  (if 
not  equal  to  PN)  is  an  element  of  the  path  reachable  set  desired;  the 
pointer  to  its  NODE  cell  is  added  to  the  output  array  of  pointers 
RSET.   IR  is  similar  to  IW,  indicating  the  last  element  in  RSET. 

The  pointer  array  SAVEP  and  the  integer  array  SAVEN  stores  pointers 
to  ARC  cells  and  the  current  value  of  IW  respectively.   These  arrays 
are  used  to  construct  another  arc  progression.   The  index  of  the  last 
element  of  both  of  these  arrays  is  stored  in  the  integer  variable  IS. 
ARC  is  a  pointer  variable  identifying  an  ARC  cell.   ND  is  a  pointer 
variable  identifying  a  NODE  cell. 

ALGORITHM  P(PN,N,RSET,IR) 


11. 

IW  < — 

0 

12. 

IS  < 

0 

13. 

IR  < 

0 

14. 

ARC  <— 

-     PN's   DOWN 

15.  IF  ARC   =  NULL  THEN   RETURN 

51.  IF  ARC's   MORE   =  NULL  THEN  GO  TO  STEP  Wl. 

52.  IS  < IS  +    1 

53.  SAVEP(IS)   < ARC's   MORE 

54.  SAVEN (IS)  < IW 

Wl.  ND  < ARC's    SON 

W2  .  IW  < IW  +   1 

W3.  WSEQ(IW)   < ARC 
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Tl.  CALL  CHECK(WSEQ,IW, RESULT) 

T2.  IF  RESULT  =  2  THEN  GO  TO  STEP  PI. 

T3.  IF  IW  =  N  THEN  GO  TO  STEP  Al. 

T4.  IF  ND's  DOW,:  =  NULL  THEN  GO  TO  STEP  Pi. 

T5.  ARC  < ND's  DOWN 

T6.  GO  TO  STEP  SI. 

PI.  IF  IS  =  0  THEN  RETURN 

P2.  ARC  < SAVE P( IS) 

P3.  IW  < SAVE N( IS) 

P4.  IS  < IS  -  1 

P5.  GO  TO  STEP  SI. 

Al.  IF  WSEQ(IW)'s  SON  -  PN  THEN  GO  TO  STEP  Pi. 

A2  .  IR  < IR  +  1 

A3.  RSET(IR)  < WSEQ(IW)'s  SON 

A4.  CALL  CHECK(RSET,IR, RESULT) 

A5.  IF  RESULT  =  1  THEN  GO  TO  STEP  Pi. 

A6.  IR  < IR  -1 

A7.  GO  TO  STEP  Pi. 

Steps  II  through  15  initialize  the  system;  SI  through  S4  save 
pointers  necessary  to  constri    the  next  arc  progression  to  be  inves- 
tigated; and  Wl  through  W3  add  an  arc  to  the  arc  progression  in  WSEQ. 
Steps  Tl  through  T6  check  the  progression  to  insure  that  no  arc  is 
duplicated  and  if  N  arcs  are  in  the  progression,  then  control  is 
transferred  to  step  Al.   PI  through  P5  resets  ARC  and  IW  so  that 
another  progression  is  checked.   If  no  more  are  to  be  checked,  the 
algorithm  terminates  returning  RSET  and  IR.   Al  through  A7  check  to 

insure  v,  ^  v  ,,  and  if  not,  v  , n  is  added  to  RSET  permanently  if  not 
1    n+1  n+1 

already  in  RSET.   The  next  progression  is  then  explored. 

This  algorithm  can  be  modified  to  return  the  cumulative  (path) 
reachable  set  or  the  (path)  reachable  set  of  a  sequence  of  nodes. 


41 


IV.   CONCLUSION 

The  system  designed  provides  an  input/output  interface  between  the 
directed  graph  problem  and  the  computer.   Since  pictures  of  graphs 
often  are  heuristically  useful  in  obtaining  solutions  to  some  problems, 
a  graphic  display  unit  is  used  on  which  to  present  a  drawing  of  the 
graphs.   Also,  through  the  unit's  light  pen  and  function  keyboard,  the 
user  may  interact  with  the  graphs --thus  providing  an  on-line  graph 
design  capability.   Upon  specified  interrupt  actions,  user-written 
analysis  routines  are  invoked  which  have  access  to  the  list  structure 
built  and  maintained  by  the  system  to  represent  the  directed  graphs. 
System  routines  which  may  be  invoked  by  user-written  procedures  are 
provided  to  aid  in  the  design  and  implementation  of  the  system  for  a 
specific  application. 

Because  the  system  is  not  designed  for  a  particular  application,  a 
non-trivial  programming  task  is  left  to  the  user.   Also,  the  fact  that 
the  storage  for  the  list  structure  is  dynamically  allocated  means  that 
the  user-written  programs  should  be  written  in  either  PL/l  or  assembler. 
List  processing,  in  itself,  usually  is  not  undertaken  by  the  novice 
programmer.   Therefore,  the  field  of  probable  users  is  somewhat  limited. 

The  PL/l  language  of  the  IBM  360/67  restricts  the  total  amount  of 
storage  dynamically  allocated  to  based  structures  to  16  bytes.   There- 
fore, when  this  storage  is  filled,  no  more  nodes  or  arcs  may  be  allocated 
Hence,  a  sub-system  handling  the  temporary  storage  of  graphs  on  a  mass 
storage  medium  is  a  necessary  addition  to  the  system  to  allow  the 
analyses  of  large  graphs. 
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Also,  the  number  of  nodes  and  arcs  displayed  is  limited  by  the 
size  of  the  buffer  of  the  IBM  2250  Display  Unit.   A  4K,  8K,  16K,  or 
32K  byte  buffer  may  be  installed  in  the  2250.   A  4K  buffer  allows 
approximately  twenty  nodes  and  arcs  to  be  displayed  at  any  one  time. 

At  the  time  of  publication  of  this  paper,  many  IBM  360/67  systems 
are  replacing  the  IBM  Operating  System  with  IBM's  TSS  which  does  not 
support  PL/l  or  the  2250.   However,  IBM  has  announced  that  both  will 
be  supported  eventually.   Random  access  is  not  to  be  supported  under 
TSS.   This  may  severely  restrict  the  use  of  a  mass  storage  medium  for 
temporary  storage  of  directed  graphs. 

Other  graph  theoretic  systems  have  been  designed.   An  extension  to 
ALGOL  was  designed  by  S.  Crespi-Reghizzi  and  R.  Morpurgo  [2]  to  allow 
specification  and  manipulation  of  graphs  in  the  source  language.   It 
is  not  interactive,  does  not  allow  the  representation  of  many  nodes  by 
one  node  and  doer  not  provide  a  display  capability.   It  does  use 
dynamic  storage  allocation  and  allows  directed  and  undirected  graphs. 
Real  numeric  fields  may  be  associated  with  nodes  and  arcs. 

Michael  S.  Wolfberg  [3]  designed  and  implemented  an  interactive 
graph  theory  system  on  the  IBM  7040  with  a  DEC-338  graphics  terminal. 
The  abstract  from  his  paper  indicates  the  I  his  system  provides,  in 
addition  to  the  graph  manipulation  options  of  this  system,  the  capa- 
bility of  entering  analysis  routines  from  the  terminal.   The  abstract 
did  not  indicate  whether  dynamic  storage  allocation  or  the  super-node 
concept  is  used. 

A  system  used  in  manipulating  trees  was  designed  and  implemented  on 
the  IBM  360/67  with  a  2250  Display  Unit  by  Claude  Holifield  [4].   His 
thesis  was  not  available  for  comparison  at  the  time  of  publication  of 
this  paper. 
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I .   INTRODUCTION 

The  Interactive  Graph  Reduction  and  Analysis  Program  provides  the 
user  with  a  software  package  which  aids  in  the  input  specification  of 
directed  graphs  to  computer  core  storage,  allows  on-line  modification 
of  the  graphs,  and  submits  a  PL/l  list  structure  representing  the 
directed  graphs  to  user-written  analysis  routines. 

The  package  is  written  in  version  4.3  of  IBM's  PL/I  (F)  program- 
ming language  and  runs  under  release  eighteen  of  the  IBM  360/67 
Operating  System.   It  uses  the  IBM  Graphic  Subroutine  Package  (Program 
Number  360S-LM-537)  to  support  the  IBM  2250-1  Display  Unit  and  executes 
in  less  than  200K  of  core  storage. 

The  system  allows  on-line  design  of  directed  graphs.   The  user  may 
input  a  directed  graph  through  the  display  unit,  then  request  his 
analysis  routines  to  be  invoked.   Output  from  the  analysis  may  be 
displayed  and  used  by  him  to  determine  changes  he  may  want  to  make  in 
the  graph.   This  interactive  process  may  continue  indefinitely. 

The  user  should  be  familiar  with  the  following  IBM  publications: 

IBM  System/360  Component  Description:   IBM  2250  Display  Unit 
Model  1.  Form  A27-2701 

IBM  System/360  Operating  System  Graphic  Subroutine  Package 
(GSP)  for  FORTRAN  IV,  COBOL,  AND  PL/I.   Form  C27-6932 

IBM  System/360  PL/l  (F)  Language.   Form  C28-8201 

IBM  System/360  Operating  System  PL/l  (F)  Programmer's  Guide, 
Form  C28-6594 

IBM  System/360  Operating  System  Linkage  Editor  and  Loader.^ 
Form  C28-6538 

IBM's  Job  Control  Language  cards  needed  to  execute  the  system  are 

shown  in  the  Computer  Program  and  Computer  Output  sections  of  this  paper 
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II.   DISPLAY  FRAMES 

At  the  IBM  2250  Display  Unit,  the  user  works  with  four  system- 
generated  pictures  or  display  frames.   Each  frame  handles  part  of  the 
total  system  task.   The  frames  are  listed  below  with  a  brief  description 
of  each.   They  are  discussed  in  detail  in  Chapter  III. 

At   INPUT  MODE  SELECTION  FRAME 

This  is  the  first  frame  displayed  by  the  system.   It  allows  the 
user  to  choose  the  initial  input  mode:   cards,  magnetic  device  or  the 
display  unit.   The  user  utilizes  the  light  pen  to  choose  the  mode  of 
input  desired. 

B,  GRAPH  MANIPULATION  FRAME 

This  is  the  frame  used  to  display  and  alter  the  directed  graphs. 
Graphs  may  be  input  through  this  frame.   User-written  analysis  routines 
are  called  from  this  frame , 

C.  GRAPH  SELECTION  FRAME 

Often  many  graphs  may  be  in  the  system  at  any  one  time.   However, 
only  one  may  be  displayed  in  the  Graph  Manipulation  Frame.   If  the 
user  wants  to  display  a  graph,  this  frame  presents  the  names  of  all 
graphs  in  the  system  and  allows  the  user  to  detect  with  the  light  pen 
the  graph  he  wants  displayed  on  the  Graph  Manipulation  Frame. 

Dc   USER  INPUT/OUTPUT  FRAME 

This  frame  is  utilized  to  display  a  "page"  of  text  generated  by  a 
user-written  routine  and  return  light  pen,  function  keyboard  and  alpha- 
numeric keyboard  information  to  the  calling  routine. 

50 


GRAPH  REDUCTION  AND  ANALYSIS  PROGRA! 


input:  gpticWs • 
1-    snn^TUBB 


X  2.   CARDS 

■ 

MAGNETIC  DEVICE 
** SELECT  ONE  0^  THE  OPTIONS  ** 


Figure  2 

The  Input  Mode  Selection  Frame.  Positioning  the  light  pen  on  option 
1,  2  or  3  relays  the  user's  request  to  the  system.  Above,  option  2, 
CARDS,  had  been  selected. 
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III.   DISCUSSION  OF  THE  DISPLAY  FRAMES 

A.  INPUT  MODE  SELECTION  FRAME 

This  frame  displays  the  three  possible  sources  of  input  to  the 

system.   The  user  selects  a  source  by  pointing  the  light  pen  at 

either  CARDS 

MAGNETIC  DEVICE 
or  BOOB  TUBE. 

Depressing  the  foot  pedal  activates  the  light  pen  detection  facility 

and  the  selection  is  transmitted  to  the  system.   If  the  light  pen  is 

not  directed  at  one  of  the  three  options  when  the  pedal  is  pressed, 

the  user  is  notified  by  the  replacement  of  the  row  of  asterisks  at 

the  bottom  of  the  display  with  the  message,  "INVALID  OPTION. . .TRY 

AGAIN." 

If  CARDS  is  selected,  the  system  reads  a  "packet"  of  data  cards 
submitted  as  file  SYSIN  of  the  job  step  which  invoked  the  execution 
of  the  system.   The  data  card  format  is  described  in  a  later  section 
of  this  manual. 

If  MAGNETIC  DEVICE  is  selected,  the  system  reads  a  similar  data 
packet  created  by  a  previous  run.   This  file  is  named  MAGINPT  and  is 
a  sequential  card  image  file  on  any  magnetic  mass  storage  device. 

If  BOOB  TUBE  is  selected,  the  system  displays  the  Graph  Manipulation 
Frame  for  on-line  input  of  graphs.   The  user  may  input  a  graph  through 
the  CARDS  option,  then  select  this  mode  to  change  the  graph. 

B.  GRAPH  MANIPULATION  FRAME 

This  frame  is  divided  into  three  regions.   One  region,  along  the 
right-hand  margin  of  the  tube,  is  used  to  display  a  list  of  options  the 
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Figure  3 

The  Graph  Manipulation  Frame  showing  49  possible  node  positions 
indicated  by  four  X's.   The  frame  is  ready  for  input  of  a  graph  to 
the  system.   Note  the  four  underscores  under  "NAME".   These  are 
replaced  by  the  graph  name.   The  options  appear  to  the  right  of  the 
node  positions.   In  a  recent  change  to  the  program,  "SAVE"  replaced 
"END"  in  the  option  list. 
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user  may  select  with  the  light  pen.   These  options  or  commands  direct 
the  system  in  manipulating  the  graphs.   Another  region  is  used  to 
display  messages  to  the  user.   The  third  and  largest  region  is  used 
to  display  a  graph  consisting  of  octagons  or  nodes  and  arrows  or  arcs 
between  octagons.   Inside  each  node  is  a  four-character  label  assigned 
by  the  user  or  a  default  label  "NNxx"  where  xx  is  a  unique  decimal 
integer.   The  first  two  characters  are  restricted  to  alphabetic 
characters. 

The  options  allow  the  user  to  add  and  delete  nodes  and  arcs,  move 
a  node  from  one  of  the  forty  nine  possible  positions  to  another, 
combine  some  of  the  nodes  displayed  into  a  graph  replacing  them  by  a 
super-node  and  to  add  nodes  to  graphs  represented  by  super-nodes.   The 
user  may  add  and  delete  super-nodes  and  store  a  displayed  graph, 
clearing  it  from  the  frame,  so  that  a  new  graph  may  be  entered.  He 
may  cause  his  analysis  routines  to  be  called  at  any  time  which  will 
have  access  to  ssystem  pointer  variables.  A  more  detailed  discussion 
of  the  options  and  their  effects  follows. 

As  mentioned  above,  the  Graph  Manipulation  Frame  is  divided  into 
three  regions:   The  GRAPH  DISPLAY  AREA  consists  of  forty  nine  possible 
locations  where  a  node  may  be  displayed.   Each  location  is  denoted  by 
the  display  of  four  X's.   If  a  node  occupies  a  location,  then  the  X's 
are  replaced  by  the  node  label  and  an  octagon  is  drawn  around  the  label 
Arcs  represented  by  arrows  may  be  displayed  between  any  two  nodes. 

The  USER  MESSAGE  AREA  is  used  to  display  messages  to  the  user. 
Upon  selecting  an  option,  instructions  are  displayed  in  this  area 
telling  the  user  which  actions  are  expected  and  what  errors  have  been 
made. 
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Figure  4 

The  option  list  of  the  Graph  Manipulation  Frame.   The  options  provide 
the  capability  of  altering  the  graph  displayed  in  the  frame.   The 
options  are  numbered  here  to  provide  a  reference  for  the  description 
of  the  options  in  Chapter  III.   Note  that  only  lines  numbered  above 
may  be  detected  by  the  light  pen. 
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The  OPTION  AREA  is  used  to  display  options  that  the  user  may 
select  with  the  light  pen.   Any  of  the  textual  lines  preceded  by  an 
underscore  in  the  option  list  may  be  detected  by  the  light  pen. 
Those  lines  are  numbered  in  Figure  4.   The  user  may  make  the  follow- 
ing option  selections: 
1.  ADD  A  NODE 

Selection  of  this  option  allows  the  addition  of  a  node  (simple 
or  super-node)  to  the  graph  currently  displayed.   If  the  screen  is 
clear  and  the  graph  name  (appearing  just  below  the  text  "NAME"  and 
just  above '^OPTIONS:")  is  M_     _",  then  the  system  will  insert  a 
cursor  in  this  graph  name  area  under  the  first  underscore  and  request 
in  the  user  message  area  that  the  user  enter  a  name  for  the  graph. 
After  the  name  has  been  entered,  pressing  any  function  key  or  gener- 
ating a  light  pen  detect  on  the  name  will  instruct  the  system  to  go 
on  to  the  next  step.   The  next  step  is  the  first  step  executed  if  the 
graph  is  already  named. 

Now,  the  system  will  instruct  the  user  to  point  the  light  pen 
at  a  vacant  node  position  denoted  by  four  X's.   If  anything  else  is 
detected  (except  _CANCEL),  the  system  displays  an  error  message  and 
requests  the  user  to  try  again.   When  a  valid  available  node  position 
has  been  detected,  a  cursor  is  inserted  under  the  first  X  and  a  new 
node  label  is  requested.   The  characters  typed  by  the  user  on  the 
alphanumeric  keyboard  will  replace  the  four  X's.   If  the  X's  are  not 
replaced,  the  system  will  provide  a  default  name  consisting  of  two  N's 
and  a  two  digit  number.   Pressing  any  function  key  or  generating  a 
light  pen  detect  on  the  label  will  instruct  the  system  to  continue. 
An  octagon  will  then  be  drawn  around  the  label  and  the  system  will 
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Figure  5 

The  Graph  Manipulation  Frame  displaying  graph  SS  1.   ADD  AN  ARC  option 
had  just  been  selected.   Note  the  message  to  the  user  requesting  the 
light  pen  (LP)  to  be  positioned  on  the  starting  node  of  the  arc  to  be 
added. 
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return  to  the  ready  state  with  the  message  displayed:   SELECT  AN 
OPTION  OR  USE  DEFAULTS.   The  default  options  are  described  later. 

If  the  node  is  to  be  a  super-node,  after  entering  the  node 
label,  a  light  pen  detect  on  the  SUPER-NODE  option  will  cause  the 
system  to  display  the  Graph  Selection  Frame,  asking  for  a  light  pen 
detect  on  the  name  of  the  graph  to  be  represented  by  the  super-node. 
After  this  selection  is  made,  the  system  will  return  to  the  Graph 
Manipulation  Frame  with  the  super-node  added. 
2  .   ADD  AN  ARC 

Selection  of  this  option  allows  the  addition  of  an  arc  (simple 
or  super-arc)  to  the  graph  currently  displayed.   If  no  graph  is  dis- 
played a  message  requesting  the  user  to  select  ADD  A  NODE  is  displayed 
and  the  system  returns  to  the  ready  state.   If  only  one  node  is  dis- 
played when  this  option  is  selected,  a  message  alerts  the  user  to 
select  ADD  A  NODE  before  an  arc  may  be  added;  loops  are  not  allowed. 

If  at  least  two  nodes  are  on  the  screen,  the  user  is  requested 
to  select  (with  the  light  pen)  the  starting  node  and  the  ending  node 
for  the  arc.   An  arrow  will  be  displayed  between  the  two  nodes, 
pointing  from  the  starting  node  to  the  ending  node.   If  either  or  both 
nodes  are  super-nodes,  the  graphs  representing  these  nodes  will  be 
displayed;  the  user  will  be  requested  to  select  a  starting  (or  ending) 
node  for  the  super-arc  in  these  graphs  and  so  forth  until  the  user  has 
eventually  specified  a  simple  node  as  the  starting  (or  ending)  node. 
3.   SUPER- NODE 

Selection  of  this  option  when  the  system  is  in  the  ready  state 
will  cause  the  graph  currently  displayed  to  be  saved  and  the  screen 
cleared  ready  for  the  entry  of  another  graph.   If  another  data  packet 
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Figure  6 

The  Graph  Manipulation  Frame  showing  the  result  from  moving  NN  2  from 
its  position  in  Figure  5  to  its  position  here.   The  arcs  were  moved  by 
the  system.   Note  the  REMOVE  A  NODE  option  had  just  been  selected. 
The  message  to  the  user  is  requesting  the  light  pen  to  be  positioned 
on  the  node  to  be  removed. 
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is  waiting  to  be  read,  the  system  will  return  to  the  Input  Mode 
Selection  Frame.   The  user  may  select  the  desired  mode. 

4.  MOVE  A  NODE 

This  option  is  included  for  aesthetic  reasons  only.   Selection 
of  this  option  allows  the  user  to  change  the  physical  (displayed) 
location  of  a  node  on  the  screen.   The  list  structure  representing 
the  graph  is  not  altered.   Upon  selection  of  this  option,  the  user 
will  be  asked  to  select  the  node  he  wishes  to  move,  then  to  select  a 
vacant  node  position.   The  node  and  all  incident  arcs  will  be  moved 
to  the  desired  position. 

5.  REMOVE  A  NODE 

Selection  of  this  option  allows  the  removal  of  a  node  from  the 
screen  and  the  list  structure.   The  user  will  be  asked  to  indicate 
the  node  he  wishes  to  be  removed  from  the  display  and  the  list 
structure.   Upon  detecting  a  node  (not  a  vacant  position),  the  node 
and  all  arcs  starting  or  ending  at  the  selected  node  will  be  removed. 
The  interface  ARC  cell  list(s)  will  be  updated  if  the  node  to  be 
removed  or  any  node  incident  with  arcs  removed  are  super-nodes. 

6.  REMOVE  AN  ARC 

Selecting  this  option  will  cause  the  arc  subsequently  detected 
to  be  removed  and  the  list  structure  to  be  updated.   A  detect  on  any- 
thing (except  __CANCEL)  will  be  flagged  as  an  error  and  the  user  will 
be  requested  to  try  again. 

7 .  CANCEL 

This  option  may  be  used  to  return  the  system  to  the  ready  state 
cancelling  the  last  option  selected.  For  example,  if  the  user  detected 
the  option  ADD  AN  ARC  and  then  realized  that  he  had  not  added  a  node 
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Figure  7 

The  Graph  Manipulation  Frame  showing  the  result  from  removing  NN  2  from 
its  position  in  Figure  6.   The  arcs  incident  with  NN  2  were  removed  by 
the  system  with  the  node.   The  user  had  just  selected  the  REMOVE  AN  ARC 
option.   Positioning  the  light  pen  on  an  arc  would  have  removed  it  from 
the  screen  and  the  graph. 
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with  which  the  arc  was  to  be  incident;  he  would  then  detect  this 
option.   The  system  would  return  to  the  ready  state,  cancelling  the 
ADD  AN  ARC  command.   He  would  then  add  the  missing  node  then  add  the 
arc.   CANCEL  may  be  used  during  the  execution  of  any  option. 

8.  SAVE 

When  the  user  is  finished  with  a  2250  session,  he  may  save 
some  or  all  of  the  directed  graphs  that  he  presently  has  in  the  system, 
Selecting  this  option  will  cause  the  Graph  Selection  Frame  to  be  dis- 
played along  with  the  word  "ALL"  at  the  right-hand  margin  of  the 
screen.   Positioning  the  light  pen  on  the  word  ALL  will  cause  all 
graphs  to  be  saved.   The  user  may  selectively  choose  with  the  light 
pen  those  graphs  to  be  saved  if  he  does  not  want  all  of  them  saved. 

When  a  graph  is  "SAVED",  the  system  writes  in  a  sequential 
card  image  output  file  named  SAVEFLE  one  data  packet  representing 
the  graph.   This  file  may  then  be  used  as  input  file  MAGINPT  in  con- 
junction with  the  MAGNETIC  DEVICE  option  of  the  Input  Mode  Selection 
Frame  to  initialize  the  system  for  a  later  run. 

9.  DISPIAY 

Selecting  this  option  allows  the  user  to  re-display  a 
previously  saved  graph.   If  after  selecting  DISPIAY,  the  user  detects 
SUPER-NODE,  the  Graph  Selection  Frame  will  be  displayed.   The  user  may 
select  a  graph  which  is  to  be  displayed  in  the  Graph  Manipulation 
Frame.   He  may  then  alter  that  graph. 

If,  after  selecting  this  option,  the  user  positions  the  light 
pen  on  a  node  or  arc,  additional  information  will  be  displayed  about 
that  node  or  arc.   Detecting  _CANCEL  will  return  the  system  to  the 
ready  state. 
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If  after  selecting  this  option,  the  user  positions  the  light 
pen  on  the  name  of  the  graph  just  above  the  text  "OPTIONS:",  infor- 
mation about  the  super-nodes  representing  the  graph  is  displayed. 
Again,  a  light  pen  detect  on  _CANCEL  will  return  the  system  to  the 
ready  state. 

10.  ANALYZE 

Selecting  this  option  will  cause  the  system  to  call  the  user 
procedure  named  ANALYZE.   See  the  chapter  "User  Routines"  for  further 
discussion. 

11.  QUIT 

Thi^  option  terminates  execution  of  the  system.   Before 
detecting  this  option  the  user  should  save  those  graphs  that  he  may 
want  to  use  to  initialize  the  system  at  the  beginning  of  the  next  run. 
See  the  SAVE  option  of  the  Graph  Manipulation  Frame. 

C.   GRAPH  SELECTION  FRAME 

When  the  user  desires  to  display  on  the  Graph  Manipulation  Frame 
a  directed  graph  which  is  in  the  system  but  not  currently  displayed, 
or  desires  to  add  a  super-node  to  a  graph,  he  will  be  presented  with 
the  Graph  Selection  Frame.   This  frame  consists  of  a  list  of  graphs  in 
the  system;  any  one  of  which  he  may  select  with  the  light  pen.   If  the 
last  item  in  the  list  is  "*M0RE",  then  the  number  of  graphs  in  the 
system  is  such  that  not  all  graph  names  may  be  displayed  at  once.   If 
the  desired  graph  is  not  on  the  list  displayed,  "*M0RE"  may  be  detected 
This  will  cause  another  group  of  graph  names  to  be  displayed.   When  the 
last  graph  name  has  been  displayed,  "*END*"  will  be  displayed  instead 
of  "*M0RE."   If  the  "*END*"  is  detected  by  the  light  pen,  the  first 
list  of  graph  names  will  be  re-displayed.   A  detect  on  the  _CANCEL 
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option  will  cause  the  command  requiring  use  of  the  Graph  Selection 
Frame  to  be  cancelled;  the  frame  from  which  it  was  called  will 
reappear . 

D.   USER  INPUT/OUTPUT  FRAME 

The  user  may  use  this  frame  to  display  textual  information  and 

accept  input  from  the  alphanumeric  keyboard,  light  pen  or  function 

keyboard.   A  call  to  the  system  routine  which  will  display  this  frame 

follows : 

DECIARE  LINE(52)  CHARACTER(74) , 

(CODE,POS)  FIXED  BINARY (31), 
DISPAGE  ENTRY ( (52 )CHAR(74), FIXED  BIN(31), 
FIXED  BIN(31)); 

CALL  DIS  PAGE  (LINE,  CODE,  POS); 

The  characters  in  LINE(l)  are  displayed  along  the  top  of  the  screen, 

LINE (2)  immediately  below  LINE(l)  and  so  forth.   The  other  calling 

arguments  are  explained  in  the  chapter  "System  Routines  and  External 

Variables . " 
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IV.   SYSTEM  ROUTINES  AND  EXTERNAL  VARIABLES 

This  chapter  describes  the  system  procedures  and  external  variables 
which  may  be  of  value  to  the  user  in  writing  his  routines. 

A.  EXTERNAL  VARIABLES 

1.  SUPLIST  (pointer)  points  to  a  list  of  ARC  cells.   Each  ARC 
cell's  SON  field  points  to  the  graph  header  cell  of  a  graph  in  the 
system.   The  cells  in  this  list  are  linked  by  the  MORE  field  of  the 
ARC  cells.   This  variable  and  the  associated  list  may  be  used  to 
access  all  the  graphs  in  the  system. 

2.  TOP  (pointer)  points  to  the  graph  header  cell  of  the  graph 
currently  displayed  in  the  Graph  Manipulation  Frame.   If  a  graph  is 
not  displayed,  this  pointer  is  set  to  the  PL/l  NUL'  pointer  value. 

3.  MES  (character (40))  is  a  forty-character  string  whose  contents 
are  displayed  in  the  user  message  area  of  the  Graph  Manipulation  Frame 
by  calling  the  system  routine  UPMES2 . 

B.  SYSTEM  ROUTINES 

1.  ALLOC  allocates  either  an  arc  or  node  cell;  initializing  the 

pointer  fields  to  the  NULL  value,  the  character  string  LABEL  (if  a 

node  cell)  to  four  blanks,  and  numeric  fields  to  zero.   The  calling 

sequence  is  as  follows: 

DECLARE  TYPE  FIXED  BINARY (15), 
POINT  POINTER, 
ALLOC  ENTRY (FLXED  BIN  (15)  ,PTR)  ; 

CALL  ALLOC  (TYPE ,  POINT)  ; 

If  TYPE  equals  1,  a  NODE  cell  is  allocated  and  initialized.   If  TYPE 

equals  2,  an  ARC  cell  is  allocated  and  initialized.   In  either  case, 
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POINT  will  identify  the  cell  allocated  upon  return  to  the  calling 
procedure. 

2.  P_ARCS  prints  on  file  SYSPRINT  all  nodes  and  arcs  of  a  graph 

specified  by  its  calling  arguments.   Starting  and  ending  simple  nodes 

and  their  respective  graphs  are  also  printed  for  super-arcs  in  the 

graph.   User-defined  variables  associated  with  each  node  and  arc  are 

also  printed  at  the  user's  disgression.   The  calling  sequence  is  as 

follows : 

DECIAREPOINT   POINTER, 

MESG  CHARACTER (n), 

P_ARCS   ENTRY(PTR,CHAR(*)) ; 

CALL  P_ARCS ( POINT, MES G) ; 

The  small  letter  n  represents  a  user-determined  value  from  one  to  120. 

POINT  is  a  pointer  identifying  the  graph  header  cell  of  the  graph  the 

user  desires  to  be  printed.   MESG  is  printed  preceding  the  printing  of 

the  graph.   It  is  printed  to  help  the  user  distinguish  between  various 

print-outs . 

To  use   P_ARCS ,    the  user   should   provide   a   procedure   called 

P__USER,   which  will   be   called   by  P_ARCS    for   each   node   and  each   arc   of 

the   graph   pointed   to  by  POINT.      See   the  next   chapter   "User  Routines" 

for  a  detailed  discussion  of  P_USER. 

3.  COPY  copies   a   graph  merging   in  copies   of  graphs    represented  by 
super-nodes.      The   graph   returned  will  not   have   any  super-nodes    or 
super-arcs.      This    routine   is    particularly  useful  when  writing  user 
analysis   routines.      Calling   this   routine  will   insure   that   the   analysis 
routine  will  not   have   to  traverse   the    interface    linkage   to  access 
simple   nodes    if   it  would  otherwise  be   necessary.      The   calling  sequence 
is   as    follows : 
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DECIARE  (PORIG,PCOPY)  POINTER, 

COPY  ENTRY (POINTER .POINTER); 

CALL  COPY(PORIG,PCOPY); 

PORIG  is  a  pointer  identifying  the  graph  header  cell  of  the  graph  to 

be  copies.   PCOPY  is  a  pointer  identifying  the  graph  header  cell  of 

the  copy  generated  upon  return  from  COPY.   Calling  FREEALL  will  return 

a  user  graph  to  available  storage.   This  should  be  done  after  analysis 

of  a  copy  is  complete. 

4.  FREEALL  v;i  11  return  a  graph  to  available  storage,  that  is, 

it  will  no  longer  exist  in  core  storage.   The  calling  sequence  is  as 

follows: 

DECIARE  POINT  POINTER, 

FREEALL  ENTRY (POINTER) ; 

CALL  FREEALL  (POINT)  ; 

POINT  should  be  set  by  the  calling  routine  to  point  to  the  graph  header 

cell  of  the  graph  to  be  returned  to  available  storage.   POINT  will  be 

returned  with  a  NULL  value. 

5.  DISPAGE  will  display  on  the  2250  a  page  of  alphanumeric  infor- 
mation.  The  page  is  set  up  by  the  user  in  any  of  his  supplied  routines, 
DISPAGE  will  also  allow  the  on-line  entry  of  74  characters  to  be 
returned  to  the  calling  routine  along  with  light  pen  and  function  key- 
board interrupt  information.   A  call  to  DISPAGE  is  made  in  the  follow- 
ing manner : 

DECIARE  LINE (52)  CHARACTER (74 ) , 

(C0DE,P0S)  FIXED  BINARY (31), 
DISPAGE  (  (52 )CHAR (74)  .FIXED  BIN(31), 
FIXED  BIN  (31)); 

CALL  D IS PAGE (LINE, CODE, POS); 

LINE(l)  is  the  top  line  displayed;  LINE (2)  is  immediately  under  LINE(l) 

and  so  forth. 
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CODE  is  the  LINE  number  (1-52)  in  which  a  cursor  will  be  inserted. 
The  user  may  then  enter  alphanumeric  characters  from  the  keyboard. 
The  characters  entered  will  replace  those  that  were  in  the  LINE  at 
the  time  of  the  call  to  DISPAGE.   If  CODE  is  less  than  one  or  greater 
than  52,  a  cursor  will  not  be  inserted. 

POS  is  the  index  (1-74)  of  the  character  in  LINE (CODE)  under  which 
the  cursor  will  be  inserted.   If  POS  is  less  than  one  or  greater  than 
74,  the  cursor  will  not  be  inserted. 

DISPAGE  will  return  to  the  user's  procedure  upon  either  of  the 
following  actions: 

a.  A  light  pen  interrupt.   Upon  positioning  the  light  pen  on 
a  character  displayed,  CODE  will  be  set  to  the  LINE  on  which  the  light 
pen  was  positioned.   POS  will  be  the  index  (1-74)  of  the  character  in 
the  LINE  detected. 

b.  A  function  key  interrupt.   Upon  pressing  a  function  key, 
CODE  will  be  set  to  a  negative  number  or  zero.   The  absolute  value  will 
equal  the  number  of  the  key  pressed. 

This  routine  provides  a  straightforward  manner  for  the  user  to 
communicate  on-line  with  his  initialization  and  analysis  routines 
N_USER,  ANALYZE,  and  BUTTONS. 
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V.   USER  ROUTINES 

The  following  procedures  should  be  supplied  by  the  user  prior  to 
running  the  system.   Two  of  them,  N_USER  and  P_USER  concern  the 
initialization  and  printing  of  user-defined  cell  fields.   ANALYZE 
and  BUTTONS  are  called  by  the  system  upon  an  on-line  user-generated 
interrupt. 

Four  fields  are  reserved  in  each  NODE  cell  for  the  user.   One 
field  is  reserved  in  each  ARC  cell.   The  user  fields  are  declared  as 
follows: 

DECIARE   1  NODE  BASED  (PP) , 

2  XCOR  FLOAT  BINARY (21), 
2  YCOR  FLOAT  BINARY (21), 
2  ON_OFF  BIT (2), 
2  USER  POINTER, 

1  ARC  BASED  (P_ARC) , 
2  USERA  POINTER, 

• 

These  fields  may  be  initialized  by  the  user  routine  N_USER  and 
referenced  by  the  user's  analysis  routines  BUTTONS  and  ANALYZE.   He 
may  design  another  cell  to  hold  additional  information  and  set  the 
pointer  fields  USER  and  USERA  to  address  these  cells. 

User  routines  which  reference  NODE  or  ARC  cells  must  contain  a 
declaration  of  NODE  or  ARC  as  it  appears  in  the  program  listing.   If 
not,  a  compiler  ;:rror  message  will  be  issued  and  the  system  will  not 
execute.   The  four  user  routines  are  described  below  in  detail. 
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A .  N_USER 

This  routine  is  called  by  the  system  each  time  a  node  or  arc  is 

added  to  or  removed  from  a  graph  through  the  Graph  Manipulation  Frame. 

The  system  calls  N_USER  in  the  following  manner: 

DECIARE  POINT  POINTER, 

IX  FIXED  BINARY (15), 

NJJSER  ENTRY (POINTER, FIXED  BIN(15)) ; 

CALL  N_USER( POINT, IX); 

POINT  will    identify  either   a   NODE  cell   or  an  ARC   cell  depending   on 

the  value   of  IX. 

If  IX  equals  one,  the  NODE  cell  identified  by  POINT  will  be  added 
to  the  graph.   Upon  return  from  N_USER,  the  system  will  display  the 
octagon  around  the  corresponding  node  on  the  screen. 

If  IX  equals  two,  the  NODE  cell  identified  by  POINT  will  be  deleted 
from  the  graph  upon  return  from  N_USER. 

If  IX  equals  three,  the  ARC  cell  identified  by  POINT  will  be  added 
to  the  graph.   Upon  return  from  NJJSER,  the  system  will  display  the 
arrow  representing  the  arc. 

If  IX  equals  four,  the  ARC  cell  identified  by  POINT  will  be  deleted 
from  the  graph  upon  return  from  N_USER. 

This  routine  is  called  before  the  deletion  of  a  cell  so  that  storage 
dynamically  allocated  for  user-defined  cells  associated  with  the  node 
and  arc  may  be  freed  before  the  pointers  to  these  cells  are  lost. 

B .  PJJSER  ■ 

This  routine  is  called  by  the  system  routine  P_A'"S.  It  allows 
the  user  to  append  text  to  that  printed  by  P_ARCS  for  each  node  and 
arc.   It  is  called  by  the  system  in  the  following  manner: 
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DECLARE  (ND,AR)  POINTER, 

MESG  CHARACTER (120), 

PJJSER  ENTRY (PTR,PTR, CHAR (120)) ; 

CALL  P_USER(ND,AR,MESG) ; 

For  each  node  that  will  be  printed  by  P_ARCS ,  a  call  to  P_USER  with  ND 

identifying  the  NODE  cell  will  be  made.   AR  will  be  set  to  NULL.   The 

user  may  fill  the  character  string  MESG  which  will  be  printed  with  the 

node  upon  return  to  P_ARCS . 

Likewise,  for  each  arc  to  be  printed,  another  call  to  P_USER  will 

be  made.   ND  will  be  NULL  and  AR  will  identify  the  corresponding  ARC 

cell.   Again,  the  MESG  returned  will  be  printed  with  the  arc. 

C .  BUTTOMS 

This  routine  is  called  by  the  system  when  the  user  presses  a 

function  key  while  the  Graph  Manipulation  Frame  is  in  the  ready  state. 

The  call  is  made  in  the  following  manner: 

DECLARE  NO  FIXED  BINARY (15), 

BUTTONS  ENTRY (FIXED  BIN(15)); 

CALL  BUTTONS (NO); 

The  variable  NO  will  be  set  to  the  number  of  the  function  key  pressed, 

zero  through  31.   By  declaring  the  based  structures  and  system  external 

variables,  the  user  has  access  to  the  graphs  in  the  system.  After 

analyzing  a  graph,  the  user  may  call  system  routine  DISPAGE  to  display 

a  page  of  alphanumeric  information  concerning  the  analysis  and,  at  the 

same  time,  retrieve  light  pen  and  function  key  information  from  the 

2250  on-line. 

D.  ANALYZE 

This  routine  is  called  if  the  light  pen  is  positioned  on  the  ANALYZE 
option  of  the  Graph  Manipulation  Frame  when  it  is  in  the  ready  state. 
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The  system  performs  the  call  with  the  statement:   CALL  ANALYZE. 
There  are  no  calling  arguments;  however,  by  declaring  the  based 
structures  and  system  external  variables,  the  user  has  access  to  the 
graphs  in  the  system.   After  analyzing  a  graph,  the  user  may  call 
system  routine  DISPAGE  to  display  a  page  of  information  concerning 
the  analysis  and,  at  the  same  time,  retrieve  light  pen  and  function 
keyboard  information  from  the  2250  on-line. 

Upon  returning  from  ANALYZE  or  BUTTONS,  the  system  will  return  to 
the  Graph  Manipulation  Frame  with  the  graph  displayed  immediately  prior 
to  the  invoking  of  the  user  routine. 
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VI.   CARD  IMAGE  FORMAT 

A  card  image  format  is  used  with  which  graphs  may  be  input  to  the 
system  instead  of  using  the  Graph  Manipulation  Frame  to  completely 
specify  a  graph.   Also,  the  system  generates  a  card  image  file  when 
the  SAVE  option  is  selected  with  the  same  card  formats. 

Four  type  of  cards  are  described  below.   Brackets  indicate  that 
information  between  them  is  optional.   Lower  case  letters  must  be 
replaced  by  entities  they  represent.   The  card  format  is  free  form  in 
card  columns  one  to  72.   If  the  data  shown  below  for  a  particular 
card  will  not  fit  on  a  single  card,  it  may  be  continued  on  the  next 
as  if  the  card  were  144  columns  wide.   The  only  places  where  spaces 
are  not  allowed  are  the  following: 

1)  Between  the  characters  of  a  node  name 

2)  Between  the  characters  of  a  graph  name 

3)  Between  the  characters  of  the  word  GRAPH 

4)  Between  the  characters  of  the  word  END 

The  cards  are  organized  in  groups  called  data  packets.   Each 
packet  defines  a  graph.   The  first  card  of  a  packet  is  the  GRAPH 
card.   It  contains  the  name  of  the  graph.   Next  node  and  arcs  are 
specified  by  the  NODE  and  ARC  cards.   Finally,  an  END  card  signifies 
the  end  of  the  packet.   A  packet  may  be  used  to  augment  a  graph 
already  in  the  system.   Several  NODE  and  ARC  cards  may  appear  in  a 
packet.   A  packet  may  be  used  to  augment  a  graph  already  in  the 
system.   Several  NODE  and  ARC  cards  may  appear  in  a  packet  inter- 
spersed.  Super-nodes  and  super-arcs  may  be  input  along  with  user- 
defined  values  to  be  associated  with  the  nodes  and  arcs. 
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A.  GRAPH  CARD 

The  GRAPH  card  starts  a  data  packet  and  contains  the  name  of  the 

graph  to  be  initialized  or  augmented. 

GRAPH  (gname) 

"gname"  is  a  user-defined,  four-character  graph  name.  If  not 
specified,  a  default  name,  SSnn,  will  be  substituted  where  nn 
is   a  decimal    integer. 

B.  NODE  CARD 

The  NODE  card  specifies  the  nodes  to  be  added  to  the  graph 

associated  with  the  packet  by  the  previous  GRAPH  card. 

N(node  specification  [,node  specification, 
...  ,node  specification]) 

"node  specification"  is  defined  as 

n-name[  (gname) ] [$  user-mes  $] 

"n-naase"  is  a  user-defined,  four-character  node  name  (of  which 
the  first  two  characters  are  alphabetic). 

"gname"  is  the  graph  represented  by  n-name  if  the  node  is  a 
super-node.   "gname"  must  be  a  graph  submitted  by  an  earlier 
data  packet  or  by  the  user  through  the  Graph  Manipulation  Frame. 

"user-mes"  is  a  maximum  of  forty  characters  passed  to  N_USER 
in  the  external  variable  MES .   The  dollar  signs  are  truncated 
from  user-mes  before  the  call  to  N_USER.   If  a  user-mes  does  not 
appear  with  a  node,  N_USER  is  not  called. 

C.  ARC  CARD 

The  ARC  card  specifies  the  arcs  for  the  graph  associated  with  the 

data  packet. 

A(arc  specification  [ ,arc  specification, 
...  ,arc  specification]) 

"arc  specification"  is  defined  as 

V-seq[$  user-mes  $] 
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"V-seq"  is  the  sequence  of  characters  V  defined  in  the  paper. 
The  first  node  named  in  both  the  starting  and  ending  portions 
of  the  sequence  are  restricted  to  be  nodes  in  the  graph  of  the 
packet.   All  nodes  in  the  sequence  must  be  previously  specified 
The  last  node  in  both  portions  of  the  sequence  must  be  a  simple 
node . 

"user-mes"  is  handled  the  same  as  user-mes  for  a  node  except 
that  the  N_USER  parameter  is  set  to  three  indicating  that  an 
arc  is  to  be  added . 


D.  END  CARD 

This  card  ends  a  data  packet. 
END 

E .  COMMENTS 

Many  packets  (graphs)  may  be  submitted  at  once.   The  graphs  may  be 
altered  and  analyzed  through  the  Graph  Manipulation  Frame  as  if  they 
were  input  through  the  2250. 
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